Les Smart Models
Les données sont modélisées à la manière d'un modèle conceptuel de données simplifié.
Un Smart Model représente un modèle d'objet : il décrit les différents champs qui le définissent ainsi que les possibles associations avec d'autres modèles. Ce modèle agit comme un moule et va permettre de créer des objets, les Smart Objects.
Le Data Modeler
Le Data Modeler est l'outil de Vision qui permet de modéliser les modèles. Chaque nœud du Data Modeler correspond à un Smart Model.
Pour créer un nouveau Smart Model, il suffit de sélectionner l'option Ajouter un Smart Model depuis le menu contextuel ou depuis la toolbar. Un nœud représentant le Smart Model se crée, il faut lui renseigner un nom. Une section Champs permet d'ajouter et de lister les propriétés du modèle.
Dans l'inspecteur du Smart Model, on trouve plusieurs options à configurer : les propriétés du modèle, ses aptitudes et ses permissions.
Les propriétés du Smart Model
Les propriétés générales du modèle
Cette section permet de définir le nom du Smart Model, sa clé, les clés uniques ainsi qu'une description.
Les clés uniques sont sélectionnables parmi les champs ajoutés au modèle. Avoir un champ déclaré comme clé unique signifie que la valeur affectée à ce champ sur les instances du modèle sera unique, il ne peut pas y avoir deux instances possédant la même valeur pour ce champ.
La description du modèle peut être utile aux concepteurs Vision mais aussi à la documentation OpenAPI que l'on peut générer pour accéder aux smartflows.
Les aptitudes du modèle
Les aptitudes sont des capacités spéciales que l'on peut accorder aux instances des Smart Models.
Aptitude | Signification |
---|---|
Document | Permet d'associer des documents aux instances du modèle |
Géolocalisation | Permet d'associer une notion de localisation par coordonnées aux instances du modèle |
Signature | Permet d'attacher une signature numérique aux instances du modèle |
Tag | Permet de taguer les instances du modèle |
Magnet | Permet d'utiliser les instances du modèle dans le Widget Board de l'UI Composer en tant que magnets |
Les permissions du modèle
Les permissions du modèle définissent quels groupes de sécurités peuvent lire (R) et / ou éditer (W) les instances des modèles. Le bouton Appliquer à tous les champs permet de rapidement appliquer la même configuration de sécurité à tous les champs du modèle.
Les champs du Smart Model
Lorsqu'on ajoute un champ au Smart Model, il faut d'abord saisir sa clé qui l'identifie. Ensuite le champ se configure depuis l'inspecteur.
Les propriétés générales
Les propriétés générales permettent de configurer la clé, le nom, le type de champ ainsi qu'une description pour le concepteur ainsi que pour la documentation OpenAPI.
Les types disponibles sont :
- les types primitifs : string (chaîne de caractères), booléen, nombre, date, time, datetime
- les type html
- le type comment : utilisé pour stocker un commentaire (utilisateur, date et contenu)
- les types objets : utilisé pour créer une liaison vers un sous-objet.
Les champs de type objets peuvent ralentir le système de recherche et peuvent être plus compliqués à utiliser dans les workflows. Il est recommandé de les utiliser qu'en cas de nécessité, pour créer des associations (quand l'objet A peut être utilisé indépendamment de l'objet B et vice-versa).
Les propriétés du champ
Cette section permet d'ajouter des options au champ.
Propriété | Signification |
---|---|
Propriété obligatoire | Ce champ doit obligatoirement être renseigné lors de l'édition par l'utilisateur d'une instance de ce modèle |
Propriété cachée | Ce champ sera toujours caché (ex: invisible dans un Formulaire) |
Propriété multiple | Ce champ représentera un tableau de valeurs (liste) |
La valeur du champ
La valeur du champ s'adaptera en fonction du type du champ.
Valeur | Signification |
---|---|
Défaut | La valeur par défaut du champ disponible pour les champs de type primitif |
Liste | Pour les champs de type string, la valeur du champ peut être limitée aux valeurs d'une liste générique |
Composition | Pour les champs de type objets, la composition permet de préciser que l'objet composé n’existera que dans son parent |
Les permissions du champ
Les permissions du champ définissent quels groupes de sécurités qui peuvent lire (R) et / ou éditer (W) le champ du modèle. Le bouton Appliquer à tous les champs permet de rapidement appliquer la même configuration de sécurité à tous les champs du modèle.